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(57) Methods, systems and articles of manufacture comprising a computer usable medium having computer readable 
program code means therein are provided for debugging multiple related processes simultaneously and more 
particularly provided for debugging multiple related processes simultaneously from one instance of a debugger. Being 
able to debug processes simultaneously in one instance of a debugger gives the user more control in recreating the 
specific ordering of events that generate a failure in processing. Further, being able to debug processes simultaneously 
from the same instance of a debugger provides usability gains and convenience by, for example, allowing the user to 
view information flowing between processes and the states of the processes- 
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ABSTRACT 



Methods, systems and articles of manufacture comprising a computer usable medium having computer 
readable program code means therein are provided for debugging multiple related processes 
simultaneously and more particularly provided for debugging multiple related processes simultaneously 
from one instance of a debugger. Being able to debug processes simultaneously in one instance of a 
debugger gives the user more control in recreating the specific ordering of events that generate a failure 
in processing. Further, being able to debug processes simultaneously from the same instance of a debugger 
provides usability gains and convenience by, for example, allowing the user to view information flowing 
between processes and the states of the processes. 
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DEBUGGING MULTIPLE RELATED PROCESSES SIMULTANEOUSLY 



FIELD OF THE INVENTION 

This invention relates to debugging multiple related processes simultaneously. More particularly, 
this invention relates to debugging multiple related processes simultaneously from one instance of a 
debugger. 

5 

BACKGROUND OF THE INVENTION 

As part of the development of software applications, software programmers frequently must 
"debug" their code to ensure it operates properly and without interruption. There are numerous debugging 
methods and techniques, including special debugging application programming interfaces and breakpoints. 

10 To aid programmers, debugging programs or debuggers have been developed. Debuggers can be 
stand-alone or integrated into another software application such as an object-oriented application 
development environment. 

Many of the current state-of-the-art debuggers do not simultaneously debug multiple related 
processes (programs) using one instance of the debugger. Related processes are processes that are 

15 spawned, directly or indirectly, from a single process. For example, a parent process may spawn child 
related processes and in turn, the child related processes may act as a parent process spawning further child 
related processes; all processes spawned in this manner are related to each other. To debug related 
processes, a user often must start one or more instances of a debugger to debug a parent process and its 
child process(es) And, an example of debuggers heretofore not simultaneously debugging multiple related 

20 processes using one instance of a debugger are those designed for the Microsoft Windows NT® and 
Windows® 95 operating systems. 

Debugging multiple related processes simultaneously can be important since processes often work 
in conjunction with other processes. One such example is the "Producer * / "Consumer" problem where 
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one process produces data or information that another process requires as input. Being able to debug both 
the Producer process and Consumer process simultaneously has advantages, especially when the 
communication between the two processes are asynchronous and the events sent between the Producer and 
Consumer occur at non-deterministic rates or occur in a non-deterministic ordering. Being able to debug 
5 both processes simultaneously gives the user more control in recreating the specific ordering of events that 
generate a failure in processing. Further, being able to debug both processes simultaneously from the same 
instance of the debugger provides usability gains and convenience by for example allowing the user to 
view information flowing between processes and the states of the processes. 

In the Windows NT and Windows 95 operating systems, the problem of debugging related 

10 processes can be understood by examining the application programming interface (API) functions these 
operating systems provide which allow debuggers to perform process control. In particular, the functions 
WaitForDebugEventO and ContinueDebugEventO are provided by Windows NT and Windows 95 to 
debug a process. The first function, WaitForDebugEventO, monitors tor the occurrence of a debug event 
in a process that has been initiated for debugging by the function ContinueDebugEvent(). When a debug 

15 event occurs in a process, that process is stalled. Debug events can include the spawning of a child process 
or a programming fault. The second function, ContinueDebugEventO, initiates debugging of a process 
and continues debugging of a process if the process has been stalled due to the occurrence of a debug event 
observed by the function WaitForDebugEventO- A key constraint that both these functions share is that 
only the thread that created the process being debugged can call WaitForDebugEventO or 

20 ContinueDebugEventO- Therefore, debugging related processes in a single instance of a debugger has 
been constrained. As has been known in the art debugging related processes can be performed by invoking 
multiple instances of debugger. Invoking multiple instances of a debugger has the apparent disadvantages 
of using more computer resources such as processing and memory. Additionally, facilitating 

As a pseudocode example, the following function, CreateProcess(), can be used to create a process 

25 on the Windows NT and Windows 95 operating systems: 

BOOL CreateProcess(LPCTSTR lpApplicationName, 
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LPSTR lpCommandLine, 

LPSECURITY_ ATTRIBUTES lpProcessAttributes, 
LPSECURITY_ ATTRIBUTES lpThreadAttributes, 
BOOL MnheritHandles, 
5 DWORD dwCreationFlags, 

LP VOID IpEnvironment, 
LPCTSTR IpCurrentDirectory, 
LPSTARTUP1N FO IpStartupInfo, 
LPPROCESSJNFORMATION lpProcessInformation 
10 ); 

The debugger loads the debuggee by making a call to CreateProcess(). The thread which executes this call 
becomes the only thread that can thereafter make calls to WaitForDebugEventO and 
ContinueDebugEvent(). We can now refer to this thread as being "special". Pseudocode to perform this 
15 might be as follows: 

// executing on "special" debugger thread 

// 

20 PROCESSJNFORMATION processjnfo; 

STARTUPINFO startup _info = {0} ; 

startupjnfo.cb = sizeoi(STARTUPINFO); 



25 



CreateProcess(NULL, 
"example.exe", 
NULL, 
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NULL, 
False, 

DEBUG_PROCESS | CRJEATE_NEW_CONSOLE | NORMAL_PRIORITY_CLASS, 
NULL, 

5 NULL, 

&startup_info, 
&process_info); 

DWORD processed = processJnfo.dwProcessId; 
10 DWORD threadid = processinfo.dwThreadld; 

Next, in order to run the newly created process, the debugger must issue a ContinueDebugEventQ 
from the "special" thread. This allows the newly created debuggee process to begin execution: 

15 // executing on "special" debugger thread 

// 

ContinueDebugEvent(processJd,thread_id,DBG_CONTINUE); 

20 In order to receive notifications about events occurring in the debuggee, the debugger must then 

issue a WaitForDebugEvent() on the "special" thread. If INFINITE is specified as the second argument 
to the call, then the WaitForDebugEvent() blocks indefinitely until an event occurs: 

// executing on "special " debugger thread 
25 // blocks until an event occurs 

// 

DEBUG_EVENT debug^event; 
WaitForDebugEvent(&debug_event,lNFINITE); 
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The debugger can be considered as being in a cycle or loop. Once WaitForDebugEventQ returns 
with an event, the debugger would respond to the event (such as a breakpoint being hit or a child process 
being spawned) and perform some action based on the event. Then, to restart the debuggee, the debugger 
5 would return back on a loop to call ContinueDebugEvent() again which will restart the debuggee. The 
pseudocode for such a cycle might be as follows: 

// executing on "special" debugger thread 

// 

10 

DEBUG_EVENT debug_event; 
M;;) { 

15 // let the debuggee process run 

// 

ContinueDebugEvent(process__id,thread_id,DBG_CONTINUE); 

20 // blocks until an event occurs 

// 

WaitForDebugEvent(&debug_event,INFINITE); 

25 // handle the event that occured 

// 

FunctionToHandleDebugEvent(debug_event); 
} 

30 

FunctionToHandleDebugEventO will handle the event (such as a breakpoint) returned via the call 
to WaitForDebugEventO by, for example, updating the state and views of the debugger and/or allowing 
the user to examine the state of the debuggee or terminate the loop. When the user has finished examining 
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the state of the debuggee, the call to FunctionToHandleDebugEvent() will return back to the loop in order 
to restart the debuggee (unless terminated within FunctionToHandleDebugEvent()). Indeed. 
FunctionToHandleDebugEveni() can block (not return) until the user wants to restart the debuggee. 

This flow of control works well when debugging a single process via this "special" thread. A 
5 problem arises when a child process is created by the process being debugged. If the debuggee at some 
point spawns another process (for example, the WaitForDebugEvent() returns a 
CREATE_PROCESS_DEBUG_EVENT) then the debugger must manage the newly created process on 
the same "special" thread. 

To handle the additional process(es), the above loop would need to be modified. 
10 ContinueDebugEvent() would need to be called for all processes being debugged, not just the original 
process. This modification is shown below by the addition of the forEachProcessBeingDebugged 
pseudo-instruction. 

// executing on "special" debugger thread 
15 // 

DEBUG_EVENT debug_event; 
for(;;) { 

20 

// let all the debuggee processes run 

// 

forEachProcessBeingDebugged { 

25 

// let the debuggee process run 
// 

ContinueDebugEvent(processjd,thread_id,DBG_CONTINUE); 

30 

} 

// blocks until an event occurs 
// 
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WaitForDebugEvent(&debug__event,INFINITE); 

// handle the event that occurred 

// 

5 

FunctionToHandleDebugEvent(debug_event); 
} 

10 However, this approach to debugging multiple related processes in the Windows NT and Windows 95 
environments can fail. One such scenario is as follows: 

1 . While process A is being debugged it spawns another process B. 

2. ContinueDebugEvent() is called for both processes in the loop above so that both process A and 
1 5 process B begin execution. 

3. WaitForDebugEvent() is called and blocks waiting for an event to occur for either process. 

4. WaitForDebugEventQ returns an event for process A. The event is handled by 
FunctionToHandleDebugEventQ and it is determined that process A should not be restarted until an event 
from process B occurs (for example, if the user set one breakpoint in process A and one breakpoint in 

20 process B, and wants to examine the state of both processes after both breakpoints have been hit). At this 
point, process B is still running; the event received for process A stops process A but not process B. So, 
FunctionToHandleDebugEvent() can do one of two things: 

a) not return to the loop (block) until the user wants process A to continue execution. 
However, while FunctionToHandleDebugEventQ is waiting for the user, process B, which is still 

25 executing, may generate a debug event. So, the user, who is waiting for a debug event to occur for process 
B, won't receive the debug event for process B because the loop to call ContinueDebugEventO has not 
been restarted. 

b) flag process A as "NO RESTART" and return to the loop. In this case, process A and 
process B would each be flagged initially as "RESTART' and the loop forEachProcessBeingDebugged 
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would be modified to forEachProcessBeingDebuggedAndRESTART in order to call 
ContinueDebugEventO only for the process(es) that are flagged as "RESTART", thereby excluding the 
process(es) flagged as "NO_R E START'. Thus, ContinueDebugEventO would be called for process B but 
not for process A. Then, WaitForDebugEventO is called and is blocked waiting for an event from process 

5 B (since only process B is running). However, the user may want to restart process A. In this example, 
the user will have wait until WaitForDebugEventO unblocks due to an event from process B; the "special" 
thread is blocked, waiting for an event from process B, and cannot be used to restart process A. 

It is desirable to provide a method, system and article of manufacture comprising a computer usable 
medium having computer readable program code means therein for debugging multiple related processes 

10 that overcomes the foregoing and other disadvantages of debugging techniques and problems. 

SUMMARY OF THE INVENTION 

Accordingly, it is an object of the invention to provide new and useful methods, systems and 
articles of manufacture comprising a computer usable medium having computer readable program code 

15 means therein for advantageously debugging multiple related processes in a single instance of a debugger. 

It is a further object of the invention to provide new and useful methods, systems and articles of 
manufacture comprising a computer usable medium having computer readable program code means therein 
that provide the ability for a user to simultaneously debug multiple related processes in order to give the 
user more control in recreating the specific ordering of events that generate a failure in processing. 

20 It is also an object of the invention to provide usability gains and convenience to a user of a 

debugger, through the ability to debug multiple related processes simultaneously from the same instance 
of a debugger, by for example allowing the user to view information flowing between processes and the 
states of the processes. 

In accordance with the invention, these and other objects are accomplished by a method for 
25 debugging multiple related processes in one instance of a debugger comprises the steps of initiating 
debugging of a plurality of related processes in said debugger, checking during a timeout period for a 
debug event that has occurred within said related processes, if a debug event has occurred, processing said 
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debug event, and after said steps of checking or processing, continuing debugging of all related processes. 
Further, the step of processing said debug event may comprise, if said debug event relates to spawning of 
a related process, creating a view in a graphical user interface of said debugger with respect to said 
spawned related process. Indeed, the aforementioned methods may further comprise the steps of 
5 selectively designating a process as stopped or determining if any of said related processes are stopped, 
waiting or running and if there are no processes stopped, waiting or running, terminating the execution of 
the debugger. Also, said step of processing in said method may comprise, if said debug event relates to 
termination or completion of a related process, deleting a view in a graphical user interface of said 
debugger with respect to said terminated or completed related process. 

10 Additionally, the methods may be performed in the Windows NT operating system. Particularly, 

in the Windows NT operating system, the step of checking may comprise executing the 
WaitForDebugEvent() command for said timeout period and the steps of initiating and continuing 
comprise executing the ContinueDebugEventO command for said related processes. 

A method for debugging a program is provided comprising the steps of designating a plurality of 

15 related processes of the program for debugging in a single instance of a debugger, determining during a 
timeout period whether a debug event has occurred among said plurality of related processes, if a debug 
event has occurred, processing said debug event, and performing said steps of designating, determining 
or processing repeatedly until all said related processes are terminated. 

Further, in accordance with this invention, an article of manufacture is provided comprising a 

20 computer usable medium having computer readable program code means therein for debugging multiple 
related processes in one instance of a debugger, the computer readable program code means in said 
computer program product comprising computer readable code means for initiating debugging of a 
plurality of related processes in said debugger, computer readable code means for checking during a 
timeout period for a debug event that has occurred within said related processes, computer readable code 

25 means for processing said debug event if said debug event has occurred, and computer readable code 
means for continuing debugging of all related processes after said checking or processing. Further, the 
computer readable code means of processing said debug event may comprise computer readable code 
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means for, if said debug event relates to spawning of a related process, creating a view in a graphical user 
interface of said debugger with respect to said spawned related process. The aforesaid article of 
manufacture may further comprise computer readable code means for selectively designating a process as 
stopped. The above article of manufacture may further comprise computer readable code means for 

5 determining if any of said related processes are stopped, waiting or running, and computer readable code 
means for, i f there are no processes stopped, waiting or running, terminating the execution of the debugger. 
Also, said computer readable code means of processing said debug event may comprise computer readable 
code means for, if said debug event relates to termination or completion of a related process, deleting a 
view in a graphical user interface of said debugger with respect to said terminated or completed related 

10 process. Further, said computer readable code means for processing said debug event may comprise 
computer readable code means for stopping a related process based upon a type of said debug event. 

The aforementioned articles of manufacture may comprise computer readable code means is 
capable of execution in the Windows NT operating system. Further, said computer readable code means 
for checking may comprise computer readable code means for executing the WaitForDebugEvent() 

15 command for said timeout period and said computer readable code means for initiating and continuing 
comprise computer readable code means for executing the ContinueDebugEvent() command for said 
related processes. 

An article of manufacture is provided comprising a computer usable medium having computer 
readable program code means therein for debugging a program, the computer readable program code 

20 means in said computer program product comprising computer readable code means for designating a 
plurality of related processes of the program for debugging in a single instance of a debugger, computer 
readable code means for determining during a timeout period whether a debug event has occurred among 
said plurality of related processes, computer readable code means for, if a debug event has occurred, 
processing said debug event, and computer readable code means for performing said steps of designating, 

25 determining or processing repeatedly until all said related processes are terminated. 

Lastly, a computer system for debugging multiple related processes in one instance of a debugger 
is provided comprising means for initiating debugging of a plurality of related processes in said debugger. 
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means for checking during a timeout period for a debug event that has occurred within said related 
processes, means for processing said debug event if a debug event has occurred, and means for continuing 
debugging of all related processes after said checking or processing. Also, a computer system for 
debugging a program is provided comprising means for designating a plurality of related processes of the 
5 program for debugging in a single instance of a debugger, means for determining during a timeout period 
whether a debug event has occurred zimong said plurality of related processes, means for, if a debug event 
has occurred, processing said debug event; and means for performing said steps of designating, 
determining or processing repeatedly until all said related processes are terminated. 

BRIEF DESCRIPTION OF THE DRAWINGS 

FIG. 1 is a flow chart which illustrates the process of debugging multiple related processes in 
accordance with the present invention. 

FIG. 2 illustrates the graphical user interface of an embodiment of the present invention showing 
information regarding a parent process. 

FIG. 3 illustrates the graphical user interface of an embodiment of the present invention showing 
information regarding a child process spawned from the parent process of FIG. 2; 

FIG. 4 illustrates the graphical user interface of an embodiment of the present invention showing 
information regarding the state of the parent process referred to in FIG. 3; and 

FIG. 5 illustrates the graphical user interface of an embodiment of the present invention showing 
information regarding a further child process spawned from the parent and child processes of FIG. 3. 

DETAILED DESCRIPTION OF THE INVENTION 

Referring to FIG. 1, the preferred embodiment of the present invention capable of debugging 
multiple related processes simultaneously in one instance of a debugger will be described. A debugger 
25 according to the preferred embodiment is started wherein a process and each related process is designated 
initially for running, unless optionally otherwise designated, for example, as stopped (not shown). 
Optionally, the debugger may provide the ability to debug two or more processes and their related 
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processes, effectively allowing a user to debug two or more programs simultaneously in one instance of 
a debugger. The debugger preferably determines whether there are any stopped, waiting or running 
processes 110. A running process :s a process that is operating in its normal course of execution. A 
waiting process is a process stalled temporarily from execution by, for example, a debug event. A stopped 
5 process is a process selectively designated to discontinue its normal course of execution and can be 
selectively designated to continue its execution. If there are no stopped, waiting or running processes, e.g., 
all processes have completed execution or have been terminated, then the debugger discontinues 
processing of those processes. At this point, optionally, the debugger may be terminated, be instructed to 
restart debugging of the previously completed or terminated processes, or be instructed to debug a new set 
10 of processes. 

If there are stopped, waiting or running processes, each process is assessed to determine whether 
it is a waiting process 1 20. If it is a v/aiting process, debugging of that process is started or continued by, 
for example, a ContinueDebugEvent() command 130. That process is then removed from waiting status 
and designated as running 140. Stopped and running processes are unaffected: stopped processes remain 

15 stopped; running processes are allowed to continue. Remaining waiting processes are then checked 120 
and started or continued accordingly. 

Once the waiting processes have been started or continued, as the case may be, the debugger 
"waits" for a debug event 150 to occur in any of the processes by, for example, the issue of a 
WaitForDebugEventO command. A debug event may occur in the parent process or any child process. 

20 A debug event may occur, for example, by the spawning of a child process from a parent process, by the 
processing of a set breakpoint in a process, by an error in the process code, by the completion of a process 
or by the stopping or terminating of a process by the user. Types of debug events are well-known to those 
skilled in the art and the reference to specific types of debug events herein shall not limit the scope of the 
invention but merely serve as an example of the class of debug events in general. Indeed, the class of 

25 debug events may increase in number and variety in the future and therefore the invention herein equally 
applies to such ftiture types of debug events as the types of debug events of the present. 

The 41 waiting" step 1 50 is limited by a timeout period to check for a debug event. In a Windows 



CA 02246270 19980901 



CA9-98-019 13 

NT embodiment, the debugger would check a debug event queue, by means of the WaitForDebugEventQ 
command, for the timeout period to see if a debug event has occurred. If a debug event had occurred 
during the execution of that command or occurred before initiation of that command, the command would 
return an indication of the occurrence of a debug event because of the presence of a debug event of the 
5 queue. Otherwise, there would be no indication of a debug event. 

The timeout period may be in the range of 1 millisecond to 10 seconds, and preferably is 100 
milliseconds. In choosing an appropriate timeout period, some of the considerations include processing 
speed of the computer, performance of the debugger and limitations of the operating system. The actual 
timeout period shall not limit the scope of the invention as processor technology may lower the timeout 

10 period below 1 millisecond and a timeout period greater than 10 seconds may be optionally chosen (but 
such a long timeout period would clearly negatively impact debugger performance). Once the timeout 
period lapses, the debugger checks for whether a debug event has occurred 160 as returned by the 
'^waiting" step 1 50. If no debug event has been returned, the steps of ''continuing" all waiting processes 
1 20, 1 30, 1 40 are again performed, the debugger again baits'* for the timeout period to check for a debug 

15 event 150 and the debugger again checks if a debug event has been returned. 

Should a debug event occur, the debug event is processed 1 70 by, for example, updating the process 
information in the debugger by, for example, refreshing the state and views of the user interface of the 
debugger, reporting the debug event, creating a new view in the debugger's user interface in the case of 
the spawning of a child process, or removing a view in the debugger's user interface in the case of the 

20 termination or completion of a process (not shown). Process information may include information such 
as process source code, values of process data and variables and indications as to what point in process 
source code a process has executed (see generally FIGS 2-5). Additionally, a process may be manipulated 
by the user or the debugger logic by, for example, stopping or terminating a process. Designating a process 
as stopped removes that process from execution of steps 130 and 140. Processing of a debug event is 

25 well-known to those skilled in the art and the particular steps of processing a debug event are virtually 
unbounded. Once a debug event is processed, the steps of checking for whether there are any stopped, 
continuing or waiting processes 110, "continuing" all waiting processes 120, 130, 140 and all subsequent 
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steps described above are performed again. 

Throughout the execution of the debugger, any process may be, by user control or other debugger 
logic, terminated, restarted from a stopped condition or stopped during a running condition (not shown). 
For example, the termination or completion of a process may result in the removal of that process' view 
5 in the debugger's user interface. Additionally, the user may step line-by-line through the process, set 
breakpoints and perform any other conventional debugging techniques. 

Thus, in the debugger of the present invention, multiple processes may be debugged simultaneously 
such that the debugging of one process does not block debugging of the remaining processes. 

Specifically, the preferred embodiment of the present invention allows for simultaneous debugging 
10 of multiple related processes in a Windows NT and Windows 95 environment by having the call to 
WaitForDebugEventO specify a timeout period and for the loop to continuously poll for events from all 
debuggee processes. The pseudocode is as follows: 

// executing on "special' 1 debugger thread 
15 // 

DEBUG_EVENT debug_event; 
M;;) { 

20 

// let all the debuggee processes run that are supposed to run 

// 

forEachProcessBeingDebuggedAndRESTART { 

25 

ContinueDebugEvent(process_id,thread_id,DBG_CONTINUE); 
} 

// timeout if event doesn't occur 
30 // 

re = WaitForDebugEvent(&debug_event,100); // 100 millisecond timeout 



CA 02246270 1998-09-01 

CA9-98-019 15 

// handle the event that occurred if we didn't just timeout 

// 

if (rc) { 

5 FunctionToHandleDebugEventAndReturn(debugeveat); 
} 
} 

As described above, the loop JorEachProcessBeingDebuggedAndRESTART() in the debugger will 

10 only call ContinueDebugEvenU ) for those processes which are flagged as "RESTART" (alternatively, the 
loop may only call ContinueDebugEvent0 for those processes not flagged "NORESTART")- Initially, 
all processes will be flagged "RESTART" (or not be flagged "NOJtESTART" in the alternative example). 
Optionally, certain process(es) may be flagged "NO_RESTART" (stopped) in order to exclude certain 
processes from being debugged. 

15 With each process flagged "RESTART* running, the debugger calls WaitForDebugEventQ with 

a timeout period. In a preferred embodiment and as described above, the timeout period is 100 
milliseconds. If a debug event is found on the debug event queue during the timeout period, the flag RC 
is set to true; otherwise RC is false. If RC is true, the non-blocking 
FunctionToHandIeDebugEventAndReturn() is called which will flag the process generating the debug 

20 event as either "NO_RESTART" or "RESTART", process the debug event by, for example, updating the 
state and views of the debugger, and return back to the loop. Otherwise if RC is false, the loop is returned. 
Further, throughout the execution of the debugger and not shown in the pseudocode above, a user or other 
debugger logic may control the processes by, for example, terminating any or all of them, restarting any 
or all processes from a stopped condition or stopping any or all processes during a running condition (not 

25 shown). 

Without using such a polling technique, due to the constraint that both ContinueDebugEvent() and 
WaitForDebugEvent() must be executed on the thread which creates the processes, multiple related 
processes cannot be simultaneously debugged by one instance of a debugger. 

Moreover, in a preferred embodiment of the debugger, the user will have the ability to control 
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multiple related processes from within one instance of the debugger. Referring to FIG. 2, the graphical 
user interface (GUI) of an embodiment of the present invention in the IBM® VisualAge® C++ for 
Windows NT application development tool is shown. A simple program 200 that loops to spawn several 
related processes is shown. In this example, the program named "parent?" 2 1 0 has been started to create 
5 the parent process as shown on the GUI tab labelled "process.exe:3046" 230. To those skilled in the art. 
other non-graphical or graphical views to hold process information for viewing may be substituted for tabs 
such as folders and/or separate screens/pages. 

The program has been selected for debugging and a debug event is about to occur as shown at 220. 
namely the spawning of a child process. Importantly, the value of the variable i of the "for" loop in the 

10 program is 0 as shown at 240. This is the first iteration of this "for" loop and thus a first spawning of a 
child process. Continuing to FIG. 3, the spawning of a child process has been processed by establishing 
a new GUI tab 250 labelled "process.exe:3 1 09" which shows details concerning this child process as well 
as the parent process. The processing of the parent process "process.exe:3046" 230 continues as shown 
in FIG. 4 at 260 where it can be seen that the program has stepped to the next line of code from that shown 

15 at 220 in FIG. 1 . Preferably, information about the parent process may also be shown. Referring to FIG. 
4, information regarding the parent process is still shown in the instance of the debugger at GUI tab 230 
and a user may optionally select to view the parent or child process by choosing the appropriate tab in the 
debugger GUI. Turning to FIG. 5, it can be seen that the program has continued by iterating through the 
"for" loop as shown by the value I of the variable i at 280. The spawning of a second child process results 

20 in another debug event which is processed to create a GUI tab 270 labelled "process.exe:3558" which 
shows details concerning this child process as well as the parent process (not shown). As can be seen in 
FIG. 5, the parent process and its child processes may be debugged in a single instance of a debugger. 
Debug events in multiple related processes may be handled by creating new tabs in the user interface or 
updating existing tabs as the case may be and a user may select to view and manipulate these processes. 

25 Optionally, information which relates these multiple processes together may be viewed and linked together 
in the debugger's GUI. 

While the preferred embodiment of this invention has been described in relation to the Windows 
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95 / NT operating systems, this invention need not be solely implemented in this operating environment. 
Indeed, an operating system or computing environment that restricts a thread of execution to act on a 
certain process and all related processes may take advantage of the present invention. Further, any 
operating system or computing environment that provides for debugging of a process and all related 
5 processes but that blocks on the occurrence of a debug event within any of the process or its related 
processes may also take advantage of this invention. 

Optionally, the invention may be implemented such that the handling of multiple related processes 
can be done selectively based on types of break events or selectively based on the processes. For example, 
certain or all processes may be stopped on the occurrence of any or a particular break event. Similarly, 

1 0 certain or all processes may be designated to restart upon the occurrence of any or a particular break event. 
Certain break events may be ignored. More particularly, using the preferred embodiment as an example, 
the step for processing a break event, which can include updating the state and views of the debugger, can 
be supplemented with functionality to process the handling of certain or all break events and the restart and 
stopping of all or certain processes. Finally, certain or all processes may be designated as stopped at the 

15 commencement of debugging to exclude certain processes from debugging. 

The invention may be implemented as an article of manufacture comprising a computer usable 
medium having computer readable program code means therein for executing the method steps of the 
invention. Such an article of manufacture may include, but is not limited to, CD-ROMs, diskettes, tapes, 
hard drives, and computer RAM or ROM. Also, the invention may be implemented in a computer system. 

20 A computer system may comprise a computer that includes a processor and a storage device and 
optionally, a video display and an input device. Moreover, a computer system may comprise an 
interconnected network of computers. 

While this invention has been described in relation to preferred embodiments, it will be understood 
by those skilled in the art that changes in the details of processes and structures may be made without 

25 departing from the spirit and scope of this invention. Thus, it should be understood that the above 
described embodiments have been provided by way of example rather than as a limitation. 
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The embodiments of the invention in which an exclusive property or privilege is claimed are defined as 
follows: 

1 1 . A method for debugging multiple related processes in one instance of a debugger comprising the 

2 steps of: 

3 initiating debugging of a plurality of related processes in said debugger; 

4 checking during a timeout period for a debug event that has occurred within said related processes; 

5 if a debug event has occurred, processing said debug event; and 

6 after said steps of checking or processing, continuing debugging of all related processes. 

1 2. The method of claim 1 , wherein the step of processing said debug event comprises, if said debug 

2 event relates to spawning of a related process, creating a view in a graphical user interface of said debugger 

3 with respect to said spawned related process. 

1 3. The method of claim 1 or 2, further comprising the step of selectively designating a process as 

2 stopped. 

1 4. The method of any one of claims 1 to 3, further comprising the step of: 

2 determining if any of said related processes are stopped, waiting or running; and 

3 if there are no processes stopped, waiting or running, terminating the execution of the debugger. 

1 5. The method of any one of claims 1 to 4, wherein the step of processing said debug event comprises 

2 stopping a related process based upon a type of said debug event. 

1 6. The method of any one of claims 1 to 5, wherein the step of processing said debug event comprises, 

2 if said debug event relates to termination or completion of a related process, deleting a view in a graphical 

3 user interface of said debugger with respect to said terminated or completed related process. 
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I 7. The method of any one of claims I to 6 performed in the Windows NT operating system. 

1 8. The method of claim 7, wherein the step of checking comprises executing the 

2 WaitForDebugEventO command for said timeout period and the steps of initiating and continuing 

3 comprise executing the ContinueDebugEvent() command for said related processes. 

1 9. A method for debugging a program comprising the steps of: 

2 designating a plurality of related processes of the program for debugging in a single instance of a 

3 debugger; 

4 determining during a timeout period whether a debug event has occurred among said plurality of 

5 related processes; 

6 if a debug event has occurred, processing said debug event; and 

7 performing said steps of designating, determining or processing repeatedly until all said related 

8 processes are terminated. 

1 10. An article of manufacture comprising a computer usable medium having computer readable 

2 program code means therein for debugging multiple related processes in one instance of a debugger, 

3 the computer readable program code means in said computer program product comprising: 

4 computer readable code means for initiating debugging of a plurality of related processes in 

5 said debugger, 

6 computer readable code means for checking during a timeout period for a debug event that has 

7 occurred within said related processes; 

8 computer readable code means for processing said debug event if said debug event has occurred; 

9 and 

10 computer readable code means for continuing debugging of all related processes after said checking 

1 1 or processing. 
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1 11. An article of manufacture of claim 1 0, wherein the computer readable code means of processing 

2 said debug event comprises computer readable code means for, if said debug event relates to spawning of 

3 a related process, creating a view in a graphical user interface of said debugger with respect to said 

4 spawned related process. 

1 12. An article of manufacture of claim 1 0 or 1 1 , further comprising computer readable code means for 

2 selectively designating a process as stopped. 

1 13. An article of manufacture of any one of claims 1 0 to 12, further comprising: 

2 computer readable code means for determining if any of said related processes are stopped, waiting 

3 or running; and 

4 computer readable code means for, if there are no processes stopped, waiting or running, 

5 terminating the execution of the debugger. 

1 14. An article of manufacture of any one of claims 10 to 13 wherein said computer readable code 

2 means for processing said debug event comprises computer readable code means for stopping a related 

3 process based upon a type of said debug event. 

1 15. An article of manufacture of any one of claims 1 0 to 1 4 wherein the computer readable code means 

2 of processing said debug event comprises computer readable code means for, if said debug event relates 

3 to termination or completion of a related process, deleting a view in a graphical user interface of said 

4 debugger with respect to said terminated or completed related process. 

1 16. An article of manufacture of any one of claims 10 to 15 wherein said computer readable code 

2 means is capable of execution in the Windows NT operating system. 

117. An article of manufacture of claim 1 6, wherein said computer readable code means for checking 
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2 comprises computer readable code means for executing the WaitForDebugEvent() command for said 

3 timeout period and said computer readable code means for initiating and continuing comprise computer 

4 readable code means for executing the ContinueDebugEvent() command for said related processes. 

1 18. An article of manufacture comprising a computer usable medium having computer readable 

2 program code means therein for debugging a program, the computer readable program code means in said 

3 computer program product comprising: 

4 computer readable code means for designating a plurality of related processes of the program for 

5 debugging in a single instance of a debugger; 

6 computer readable code means for determining during a timeout period whether a debug event has 

7 occurred among said plurality of related processes; 

8 computer readable code means for, if a debug event has occurred, processing said debug event; and 

9 computer readable code means for performing said steps of designating, determining or processing 

10 repeatedly until all said related processes are terminated. 

119. A computer system for debugging multiple related processes in one instance of a debugger 

2 comprising: 

3 means for initiating debugging of a plurality of related processes in said debugger; 

4 means for checking duri ng a timeout period for a debug event that has occurred within said related 

5 processes; 

6 means for processing said debug event if a debug event has occurred; and 

7 means for continuing debugging of all related processes after said checking or processing. 

1 20. A computer system for debugging a program comprising: 

2 means for designating a plurality of related processes of the program for debugging in a single 

3 instance of a debugger; 

4 means for determining during a timeout period whether a debug event has occurred among said 
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5 plurality of related processes; 

6 means for, if a debug event has occurred, processing said debug event; and 

7 means for performing said steps of designating, determining or processing repeatedly until all said 

8 related processes are terminated. 
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